home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs55.d81 / cpwrdocs.arc / OUTLINE.TWO < prev   
Text File  |  2009-10-10  |  4KB  |  158 lines
  1.  
  2. --------------------------------------
  3.  
  4.               ├ ╨OWER ├ 
  5.         ╒SER'S ╧UTLINE PART 2
  6.  
  7. --------------------------------------
  8.  
  9.  
  10. ├OMPILER (CC.SH,COMPILER,TRANSLATOR) -
  11.  
  12. ┴T THE SHELL PROMPT TYPE ($) TYPE
  13. 'CC [-P] FILENAME.C' <RETURN>
  14. AND THE COMPILER WILL BE LOADED AND 
  15. RUN WITH THE SPECIFIED 'FILENAME.C'.
  16. ╔F YOU TYPE IN THE '-P' PRIOR TO THE
  17. 'FILENAME.C' THE COMPILER WILL ASSUME 
  18. THAT YOU ARE USING TWO DISK DRIVES.
  19. ╔F YOU HAVE 1 DISK DRIVE AND HAVE 
  20. CREATED A COMBINATION SYSTEM-WORK DISK
  21. AS DESCRIBED IN PART ONE YOU CAN USE
  22. THE '-P' SWITCH TO MAKE THE COMPILER DO
  23. A COMPLETE COMPILE WITHOUT PROMPTING
  24. YOU TO SWAP DISKS.
  25. ╘HE FILENAME SHOULD ┴╠╫┴┘╙ END WITH
  26. '.C'. ╫HEN FINISHED, THE COMPILER WILL
  27. LEAVE AN OBJECT FILE ON THE WORK DISK
  28. WITH THE SAME NAME AS THE SOURCE FILE
  29. EXCEPT THE EXTENSION '.C' WILL BE
  30. REPLACED WITH '.O' TO INDICATE AN
  31. OBJECT FILE.
  32.  
  33. ╔T IS A GOOD IDEA TO KEEP YOUR SOURCE
  34. CODE FILES TO A SIZE OF 35 BLOCKS OR
  35. LESS SINCE THE COMPILER WILL COMPLAIN
  36. AND REFUSE TO PROCESS FILES THAT ARE
  37. TOO LARGE. ╞OR LARGE PROGRAMS THIS 
  38. MEANS A PROGRAM WILL BE COMPOSED OF 
  39. MORE THAN ONE SOURCE FILE. ╔F THIS IS
  40. NECESSARY CONSULT A TUTORIAL BOOK ON
  41. HOW TO USE THE 'EXTERN' VARIABLE 
  42. DECLARATOR FOR VARIABLES SHARED BETWEEN
  43. TWO OR MORE SOURCE FILES.
  44.  
  45. ╘RIM (TRIM.SH) -
  46.  
  47. ╘RIM OPTIMIZES OBJECT MODULES PRODUCED
  48. BY THE COMPILER (IE. ENDING IN '.O' OR
  49. '.OBJ') PRIOR TO PROGRAM LINKING. ╞ILE
  50. SIZES ARE REDUCED FROM 3 TO 12 PER 
  51. CENT. ╘O USE TRIM LOAD IT WITH:
  52.  
  53. $ LOAD TRIM
  54.  
  55. ╘HEN TRIM YOUR OBJECT MODULE(S) WITH:
  56.  
  57. $ TRIM [FILENAME.O]
  58.  
  59. ─O NOT TRIM A FILE MORE THAN ONCE.
  60.  
  61.  
  62. ╠INKER (LINK.SH) -
  63.  
  64. ┴T THE SHELL PROMPT ($), TYPE IN
  65. 'LINK [-S] [ADDRESS] <RETURN>' TO
  66. LOAD AND RUN THE LINKER. ╘O LINK A
  67. PROGRAM TO RUN WITHIN THE SHELL LEAVE
  68. OUT THE '-S' OPTION. ╒SING THE '-S'
  69. OPTION WILL TELL THE LINKER YOU WANT
  70. YOUR PROGRAM TO RUN FROM ┬┴╙╔├ AND
  71. INDEPENDENTLY OF THE ├ ╨OWER SHELL. 
  72. ┴LL PROGRAMS WHICH ARE TO RUN INSIDE
  73. THE SHELL MUST END WITH '.SH'. ╔F NO
  74. 'ADDRESS' IS GIVEN THE PROGRAMS WILL BE
  75. LINKED TO START AT THE DEFAULT LOCATION
  76. SO THAT THEY CAN BE ╠╧┴─ED AND ╥╒╬. ╔F
  77. AN ADDRESS IS SPECIFIED,IN EITHER 
  78. HEXADECIMAL (WHICH IS PRECEEDED BY $)
  79. OR DECIMAL, THEN THE PROGRAM WILL BE 
  80. LINKED TO LOAD STARTING AT THAT ADDRESS
  81. AND YOU WILL USUALLY HAVE TO 'SYS' FROM
  82. WITHIN ┬┴╙╔├ TO THAT STARTING ADDRESS
  83. TO RUN THE PROGRAM.
  84. ╘HE LINKER LOOKS FOR YOUR OBJECT FILES
  85. WHICH END IN '.O' ON THE WORK DISK AND
  86. THE LIBRARY FILES ARE LOOKED FOR ON THE
  87. SYSTEM DISK. ╫ITH 1 DRIVE THE SYSTEM
  88. AND WORK DISKS ARE ON THE SAME DRIVE.
  89.  
  90. ╘HE LINKER WILL ONLY ACCEPT FILES WHOSE
  91. NAMES END WITH '.O', '.OBJ' OR '.L'.
  92.  
  93. ╘HE LINKER PROMPT IS A '>'. ╘YPE IN THE
  94. NAME(S) OF YOUR OBJECT '.O' FILES AT
  95. THE PROMPT, HITTING <RETURN> AFTER EACH,
  96. WHICH MEANS ONLY ONE ON EACH LINE AS
  97. THEY WILL BE LOADED BY THE LINKER ONE
  98. AT A TIME. 
  99. ╫HEN YOU HAVE FINISHED THIS YOU EITHER
  100. INSERT THE LIBRARY DISK IF YOU ARE 
  101. WORKING WITH ONLY ONE DRIVE, OR IF YOU 
  102. HAVE 2 DRIVES GO ON DIRECTLY TO
  103. PRESSING '^'(ARROW UP) THEN <RETURN>. 
  104. ╘HIS WILL TELL THE LINKER TO LINK IN
  105. THE NEEDED FUNCTIONS FROM THE STANDARD
  106. LIBRARY AND THE SYSTEM LIBRARY. 
  107. ╔F YOU HAVE OBJECT MODULES IN A LIBRARY
  108. YOU'VE CREATED YOURSELF THEN JUST GIVE
  109. THE WHOLE LIBRARY NAME, INCLUDING THE
  110. REQUIRED '.L' EXTENSION, AT THE LINKER
  111. PROMPT AND ╠╔╬╦ WILL SEARCH IT FOR ANY 
  112. OBJECT MODULES THAT ARE CALLED FROM
  113. WITHIN YOUR PROGRAM.
  114.  
  115. ╫HEN THIS IS FINISHED HIT <RETURN>. ╔F
  116. YOU GET AN "UNRESOLVED EXTERNAL 
  117. REFERENCE" MESSAGE THEN YOU FORGOT TO 
  118. LINK IN SOMETHING. ╬O PROBLEM, JUST
  119. LINK IN THAT SOMETHING NOW.
  120.  
  121. ╔F YOU NEED TO EXIT THE LINKER FOR ANY
  122. REASON JUST ENTER AN 'X' AT THE LINKER
  123. PROMPT AND HIT <RETURN> TO GET BACK TO
  124. THE SHELL.
  125.  
  126. ╧NCE EVERYTHING IS LINKED YOU ARE ASKED
  127. FOR THE NAME OF THE PROGRAM TO BE SAVED
  128. TO DISK WITH THE MESSAGE:
  129.  
  130. OUTPUT FILE:
  131.  
  132. ┴ TYPICAL SIMPLE LINK TO MAKE A FILE
  133. TO RUN FROM ┬┴╙╔├ (OUTSIDE THE SHELL)
  134. WOULD GO SOMETHING LIKE THIS:
  135.  
  136. LINK -S
  137.  
  138. > FILENAME.O  (YOUR FIRST OBJECT FILE)
  139. > FILENAME.O  (YOUR SECOND OBJECT FILE
  140.                IF YOU HAVE ONE)
  141. > ^           (STANDARD LIBRARY STUFF)
  142. > MYLIB.L     (A USER-CREATED LIBRARY)
  143. > <RETURN>    (YOU ARE DONE LINKING)
  144.  
  145. OUTPUT FILE: FILENAME (OF YOUR CHOICE)
  146.  
  147.  
  148. ╘O LINK A FILE TO RUN WITHIN THE ├ ╨OWER
  149. SHELL JUST USE 'LINK' WITHOUT THE '-S'
  150. ON THE COMMAND LINE AND WHEN ASKED FOR
  151. 'OUTPUT FILE:' YOU ═╒╙╘ PUT AN '.SH'
  152. AT THE END OF THE FILENAME. ╬OTE THAT
  153. TO RUN SUCH A PROGRAM YOU JUST GIVE ITS
  154. NAME WITHOUT THE '.SH' AT THE '$'.
  155.  
  156. - END -
  157.  
  158.